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ABOUT THIS CHAPTER 


This chapter describes the Desk Manager, the part of the Toolbox that supports 
the use of desk accessories from an application; the Calculator, for example, is 
a standard desk accessory available to any application. You'll learn how to use 
the Desk Manager routines and how to write your own accessories. 


You should already be familiar with: 
e the basic concepts behind the Resource Manager and QuickDraw 
¢ the Toolbox Event Manager, the Window Manager, the Menu Manager, 
and the Dialog Manager 
e device drivers, as discussed in the Device Manager chapter, if 
you want to write your own desk accessories 
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ABOUT THE DESK MANAGER 


The Desk Manager enables your application to support desk accessories, which are 
"mini-applications" that can be run at the same time as a Macintosh application. 
There are a number of standard desk accessories, such as the Calculator shown in 
Figure 1. You can also write your own desk accessories if you wish. 


Active 


Figure 1-The Calculator Desk Accessory 


Figure 1—The Calculator Desk Accessory 


The Macintosh user opens desk accessories by choosing them from the standard 
Apple menu (whose title is an apple symbol), which by convention is the first 
menu in the menu bar. When a desk accessory is chosen from this menu, it's 


usually displayed in a window on the desktop, and that window becomes the active 
window (see Figure 2). 
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Figure 2—Opening a Desk Accessory 
Figure 2—Opening a Desk Accessory 


After being opened, the accessory may be used as long as it's active. The user 
can activate other windows and then reactivate the desk accessory by clicking 
inside it. Whenever a standard desk accessory is active, it has a close box in 
its title bar. Clicking the close box (or choosing Close from the File menu) 
makes the accessory disappear, and the window that's then frontmost becomes 
active. 


eeeClick on the X-Ref button, and refer to Technical Note #5,eee 


The window associated with a desk accessory is usually a rounded-corner window 
(as shown in Figure 1) or a standard document window, although it can be any 
type of window. It may even look and behave like a dialog window; the accessory 
can call on the Dialog Manager to create the window and then use Dialog Manager 
routines to operate on it. In any case, the window will be a system window, as 
indicated by the fact that its windowKind field contains a negative value. 


The Desk Manager provides a mechanism that lets standard commands chosen from 
the Edit menu be applied to a desk accessory when it's active. Even if the 
commands aren't particularly useful for editing within the accessory, they may 
be useful for cutting and pasting between the accessory and the application or 
even another accessory. For example, the result of a calculation made with the 
Calculator can be copied and pasted into a document prepared in MacWrite. 


A desk accessory may also have its own menu. When the accessory becomes active, 
the title of its menu is added to the menu bar and menu items may be chosen from 
it. Any of the application's menus or menu items that no longer apply are 
disabled. A desk accessory can even have an entire menu bar full of its own 
menus, which will completely replace the menus already in the menu bar. When an 
accessory that has its own menu or menus becomes inactive, the menu bar is 
restored to normal. 
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Although desk accessories are usually displayed in windows (one per accessory); 
it's possible for an accessory to have only a menu (or menus) and not a window. 
In this case, the menu includes a command to close the accessory. Also, a desk 
accessory that's displayed in a window may create any number of additional 
windows while it's open. 


A desk accessory is actually a special type of device driver—special in that it 
may have its own windows and menus for interacting with the user. The value in 
the windowKind field of a desk accessory's window is a reference number that 
uniquely identifies the driver, returned by the Device Manager when the driver 
was opened. Desk accessories and other RAM drivers used by Macintosh 
applications are stored in resource files. 
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USING THE DESK MANAGER 


To allow access to desk accessories, your application must do the following: 


¢ Initialize TextEdit and the Dialog Manager, in case any desk 
accessories are displayed in windows created by the Dialog Manager 
(which uses TextEdit). 

¢ Set up the Apple menu as the first menu in the menu bar. You can put 
the names of all currently available desk accessories in a menu by 
using the Menu Manager procedure AddResMenu. 

e Set up an Edit menu that includes the standard commands Undo, Cut, 
Copy, Paste, and Clear (in that order, with a dividing line between 
Undo and Cut), even if your application itself doesn't support any 
of these commands. 


Note: Applications should leave enough space in the menu bar for a 
desk accessory's menu to be added. 


When the user chooses a desk accessory from the Apple menu, call the Menu 
Manager procedure GetItem to get the name of the desk accessory, and then the 
Desk Manager function OpenDeskAcc to open and display the accessory. When a 
system window is active and the user chooses Close from the File menu, close the 
desk accessory with the CloseDeskAcc procedure. 


Warning: Most open desk accessories allocate nonrelocatable objects 
(such as windows) in the heap, resulting in fragmentation of 
heap space. Before beginning an operation that requires a large 
amount of memory, your application may want to close all open 
desk accessories (or allow the user to close some of them). 


When the Toolbox Event Manager function GetNextEvent reports that a mouse-down 
event has occurred, your application should call the Window Manager function 
FindWindow to find out where the mouse button was pressed. If FindWindow returns 
the predefined constant inSysWindow, which means that the mouse button was 
pressed in a system window, call the Desk Manager procedure SystemClick. 
SystemClick handles mouse-down events in system windows, routing them to desk 
accessories where appropriate. 


Note: The application needn't be concerned with exactly which desk 
accessories are currently open. 


When the active window changes from an application window to a system window, 
the application should disable any of its menus or menu items that don't apply 
while an accessory is active, and it should enable the standard editing commands 
Undo, Cut, Copy, Paste, and Clear, in the Edit menu. An application should 
disable any editing commands it doesn't support when one of its own windows 
becomes active. 


When a mouse-down event occurs in the menu bar, and the application determines 
that one of the five standard editing commands has been invoked, it should call 
SystemEdit. Only if SystemEdit returns FALSE should the application process the 
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editing command itself; if the active window belongs to a desk accessory, 
SystemEdit passes the editing command on to that accessory and returns TRUE. 


Keyboard equivalents of the standard editing commands are passed on to desk 
accessories by the Desk Manager, not by your application. 


Warning: The standard keyboard equivalents for the commands in the Edit 
menu must not be changed or assigned to other commands; the Desk 
Manager automatically interprets Command-Z, X, C, and V as Undo, 
Cut, Copy, and Paste, respectively. 


Certain periodic actions may be defined for desk accessories. To see that 
they're performed, you need to call the SystemTask procedure at least once every 
time through your main event Loop. 


The two remaining Desk Manager routines—SystemEvent and SystemMenu—are never 
called by the application, but are described in this chapter because they reveal 
inner mechanisms of the Toolbox that may be of interest to advanced programmers. 
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DESK MANAGER ROUTINES 


Opening and Closing Desk Accessories 
FUNCTION OpenDeskAcc (theAcc: Str255) : INTEGER; 


OpenDeskAcc opens the desk accessory having the given name and displays its 
window (if any) as the active window. The name is the accessory's resource name, 
which you get from the Apple menu by calling the Menu Manager procedure GetItem. 
OpenDeskAcc calls the Resource Manager to read the desk accessory from the 
resource file into the application heap. 


You should ignore the value returned by OpenDeskAcc. If the desk accessory is 
successfully opened, the function result is its driver reference number. 
However, if the desk accessory can't be opened, the function result is 
undefined; the accessory will have taken care of informing the user of the 
problem (such as memory full) and won't display itself. 


Warning: Early versions of some desk accessories may set the current 
grafPort to the accessory's port upon return from OpenDeskAcc. 
To be safe, you should bracket your call to OpenDeskAcc with 
calls to the QuickDraw procedures GetPort and SetPort, to save 
and restore the current port. 


Note: Programmers concerned about the amount of available memory should 
be aware that an open desk accessory uses from 1K to 3K bytes of 
heap space in addition to the space needed for the accessory itself. 
The desk accessory is responsible for determining whether there is 
sufficient memory for it to run; this can be done by calling 
SizeResource followed by ResrvMem. 


PROCEDURE CloseDeskAcc (refNum: INTEGER); 


When a system window is active and the user chooses Close from the File menu, 
call CloseDeskAcc to close the desk accessory. RefNum is the driver reference 
number for the desk accessory, which you get from the windowKind field of its 
window. 


The Desk Manager automatically closes a desk accessory if the user clicks its 
close box. Also, since the application heap is released when the application 
terminates, every desk accessory goes away at that time. 


Handling Events in Desk Accessories 
PROCEDURE SystemClick (theEvent: EventRecord; theWindow: WindowPtr); 
When a mouse-down event occurs and the Window Manager function FindWindow 


reports that the mouse button was pressed in a system window, the application 
should call SystemClick with the event record and the window pointer. If the 
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given window belongs to a desk accessory, SystemClick sees that the event gets 
handled properly. 


SystemClick determines which part of the desk accessory's window the mouse 
button was pressed in, and responds accordingly (similar to the way your 
application responds to mouse activities in its own windows). 


¢ If the mouse button was pressed in the content region of the window 
and the window was active, SystemClick sends the mouse-down event to 
the desk accessory, which processes it as appropriate. 

e If the mouse button was pressed in the content region and the window 
was inactive, SystemClick makes it the active window. 

¢ If the mouse button was pressed in the drag region, SystemClick calls 
the Window Manager procedure DragWindow to pull an outline of the window 
across the screen and move the window to a new location. If the window 
was inactive, DragWindow also makes it the active window (unless the 
Command key was pressed along with the mouse button). 

¢ If the mouse button was pressed in the go-away region, SystemClick calls 
the Window Manager function TrackGoAway to determine whether the mouse 
is still inside the go-away region when the click is completed: If 
so, it tells the desk accessory to close itself; otherwise, it does 
nothing. 


FUNCTION SystemEdit (editCmd: INTEGER) : BOOLEAN; 


Assembly-language note: The macro you invoke to call SystemEdit from 
assembly Language is named SysEdit. 


Call SystemEdit when there's a mouse-down event in the menu bar and the user 
chooses one of the five standard editing commands from the Edit menu. Pass one 
of the following as the value of the editCmd parameter: 


editCmd Editing command 


Undo 
Cut 
Copy 
Paste 
Clear 


OBRWN® 


If your Edit menu contains these five commands in the standard arrangement (the 
order listed above, with a dividing line between Undo and Cut), you can simply 
call 


SystemEdit (menuItem- 1) 
where menuItem is the menu item number. 
If the active window doesn't belong to a desk accessory, SystemEdit returns 
FALSE; the application should then process the editing command as usual. If the 
active window does belong to a desk accessory, SystemEdit asks that accessory to 
process the command and returns TRUE; in this case, the application should 
ignore the command. 


Note: It's up to the application to make sure desk accessories get 
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their editing commands that are chosen from the Edit menu. In 
particular, make sure your application hasn't disabled the Edit 
menu or any of the five standard commands when a desk accessory 
is activated. 


Performing Periodic Actions 
PROCEDURE SystemTask; 


For each open desk accessory (or other device driver performing periodic 
actions), SystemTask causes the accessory to perform the periodic action defined 
for it, if any such action has been defined and if the proper time period has 
passed since the action was last performed. For example, a clock accessory can 
be defined such that the second hand is to move once every second; the periodic 
action for the accessory will be to move the second hand to the next position, 
and SystemTask will alert the accessory every second to perform that action. 


You should call SystemTask as often as possible, usually once every time through 
your main event loop. Call it more than once if your application does an 
unusually large amount of processing each time through the loop. 


Note: SystemTask should be called at least every sixtieth of a second. 


Advanced Routines 
FUNCTION SystemEvent (theEvent: EventRecord) : BOOLEAN; 


SystemEvent is called only by the Toolbox Event Manager function GetNextEvent 
when it receives an event, to determine whether the event should be handled by 
the application or by the system. If the given event should be handled by the 
application, SystemEvent returns FALSE; otherwise, it calls the appropriate 
system code to handle the event and returns TRUE. 


In the case of a null or mouse-down event, SystemEvent does nothing but return 
FALSE. Notice that it responds this way to a mouse-down event even though the 
event may in fact have occurred in a system window (and therefore may have to be 
handled by the system). The reason for this is that the check for exactly where 
the event occurred (via the Window Manager function FindWindow) is made later by 
the application and so would be made twice if SystemEvent were also to do it. To 
avoid this duplication, SystemEvent passes the event on to the application and 
lets it make the sole call to FindWindow. Should FindWindow reveal that the 
mouse-down event did occur in a system window, the application can then call 
SystemClick, as described above, to get the system to handle it. 


If the given event is a mouse-up or any keyboard event (including keyboard 
equivalents of commands), SystemEvent checks whether the active window belongs 
to a desk accessory and whether that accessory can handle this type of event. If 
so, it sends the event to the desk accessory and returns TRUE; otherwise, it 
returns FALSE. 
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If SystemEvent is passed an activate or update event, it checks whether the 
window the event occurred in is a system window belonging to a desk accessory 
and whether that accessory can handle this type of event. If so, it sends the 
event to the desk accessory and returns TRUE; otherwise, it returns FALSE. 


Note: It's unlikely that a desk accessory would not be set up to handle 
keyboard, activate, and update events, or that it would handle 
mouse-up events. 


If the given event is a disk-inserted event, SystemEvent does some 
low-level processing (by calling the File Manager function MountVol) 
but passes the event on to the application by returning FALSE, in 
case the application wants to do further processing. Finally, 
SystemEvent returns FALSE for network, device driver, and 
application-defined events. 


Assembly-language note: Advanced programmers can make SystemEvent 
always return FALSE by setting the global 
variable SEvtEnb (a byte) to 0. 


PROCEDURE SystemMenu (menuResult: LONGINT); 


SystemMenu is called only by the Menu Manager functions MenuSelect and MenuKey, 
when an item in a menu belonging to a desk accessory has been chosen. The 
menuResult parameter has the same format as the value returned by MenuSelect and 
MenuKey: the menu ID in the high-order word and the menu item number in the 
low-order word. (The menu ID will be negative.) SystemMenu directs the desk 
accessory to perform the appropriate action for the given menu item. 
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WRITING YOUR OWN DESK ACCESSORIES 


To write your own desk accessory, you must create it as a device driver and 
include it in a resource file, as described in the Device Manager chapter. 

Standard or shared desk accessories are stored in the system resource file. 
Accessories specific to an application are rare; if there are any, they're 

stored in the application's resource file. 


The resource type for a device driver is 'DRVR'. The resource ID for a desk 
accessory is the driver's unit number and must be between 12 and 31 inclusive. 


Note: A desk accessory will often have additional resources (such as 
pattern and string resources) that are associated with it. These 
resources must observe a special numbering convention, as described 
in the Resource Manager chapter. 


The resource name should be whatever you want to appear in the Apple menu, but 
should also include a nonprinting character; by convention, the name should 
begin with a NUL character (ASCII code 0). The nonprinting character is needed 
to avoid conflict with file names that are the same as the names of desk 
accessories. 


Device drivers are usually written in assembly language. The structure of a 
device driver is described in the Device Manager chapter. The rest of this 
section reviews some of that information and presents additional details 
pertaining specifically to device drivers that are desk accessories. 


As shown in Figure 3, a device driver begins with a few words of flags and other 
data, followed by offsets to the routines that do the work of the driver, an 
optional title, and finally the routines themselves. 
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Figure 3—Desk Accessory Device Driver 


One bit in the high-order byte of the drvrFlags word is frequently used by desk 
accessories: 


dNeedTime . EQU 5 ; set if driver needs time for performing 
; a periodic action 


Desk accessories may need to perform predefined actions periodically. For 
example, a clock desk accessory may want to change the time it displays every 
second. If the dNeedTime flag is set, the desk accessory does need to perform a 
periodic action, and the drvrDelay word contains a tick count indicating how 
often the periodic action should occur. Whether the action actually occurs as 
frequently as specified depends on how often the application calls the Desk 
Manager procedure SystemTask. SystemTask calls the desk accessory's control 
routine (if the time indicated by drvrDelay has elapsed), and the control 
routine must perform whatever predefined action is desired. 


Note: A desk accessory cannot rely on SystemTask being called regularly 
or frequently by an application. If it needs precise timing it 
should install a task to be executed during the vertical retrace 
interrupt. There are, however, certain restrictions on tasks 
performed during interrupts, such as not being able to make calls 
to the Memory Manager. For more information on these restrictions, 
see the Vertical Retrace Manager chapter. Periodic actions performed 
in response to SystemTask calls are not performed via an interrupt 
and so don't have these restrictions. 
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The drvrEMask word contains an event mask specifying which events the desk 
accessory can handle. If the accessory has a window, the mask should include 
keyboard, activate, update, and mouse-down events, but must not include mouse-up 
events. 


Note: The accessory may not be interested in keyboard input, but it 
should still respond to key-down and auto-key events, at least 
with a beep. 


When an event occurs, the Toolbox Event Manager calls SystemEvent. SystemEvent 
checks the drvrEMask word to determine whether the desk accessory can handle the 
type of event, and if so, calls the desk accessory's control routine. The 
control routine must perform whatever action is desired. 


If the desk accessory has its own menu (or menus), the drvrMenu word contains 
the menu ID of the menu (or of any one of the menus); otherwise, it contains 0. 
The menu ID for a desk accessory menu must be negative, and it must be different 
from the menu ID stored in other desk accessories. 


Following these four words are the offsets to the driver routines and, 
optionally, a title for the desk accessory (preceded by its length in bytes). 
You can use the title in the driver as the title of the accessory's window, or 
just as a way of identifying the driver in memory. 


Note: A practical size limit for desk accessories is about 8K bytes. 


The Driver Routines 


Of the five possible driver routines, only three need to exist for desk 
accessories: the open, close, and control routines. The other routines (prime 
and status) may be used if desired for a particular accessory. 

The open routine opens the desk accessory: 


« It creates the window to be displayed when the accessory is opened, 
if any, specifying that it be invisible (since OpenDeskAcc will 
display it). The window can be created with the Dialog Manager 
function GetNewDialog (or NewDialog) if desired; the accessory 
will look and respond like a dialog box, and subsequent operations 
may be performed on it with Dialog Manager routines. In any case, 
the open routine sets the windowKind field of the window record to 
the driver reference number for the desk accessory, which it gets 
from the device control entry. (The reference number will be negative.) 
It also stores the window pointer in the device control entry. 

e If the driver has any private storage, it allocates the storage, 
stores a handle to it in the device control entry, and initializes 
any local variables. It might, for example, create a menu or menus 
for the accessory. 


If the open routine is unable to complete all of the above tasks (if it runs out 
of memory, for example), it must do the following: 


¢ Open only the minimum of data structures needed to run the desk accessory. 
¢ Modify the code of every routine (except the close routine) so that 
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the routine just returns (or beeps) when called. 

« Modify the code of the close routine so that it disposes of only the 
minimum data structures that were opened. 

« Display an alert indicating failure, such as "The Note Pad is not 
available". 


The close routine closes the desk accessory, disposing of its window (if any) 
and all the data structures associated with it and replacing the window pointer 
in the device control entry with NIL. If the driver has any private storage, the 
close routine also disposes of that storage. 


Warning: A driver's private storage shouldn't be in the system heap, 
because the application heap is reinitialized when an application 
terminates, and the driver is lost before it can dispose of its 
storage. 


The action taken by the control routine depends on information passed in the 
parameter block pointed to by register AQ. A message is passed in the csCode 
parameter; this message is simply a number that tells the routine what action to 
take. There are nine such messages: 


accEvent .EQU 64 ;handle a given event 

accRun . EQU 65 ;take the periodic action, if any, 
; for this desk accessory 

accCursor  .EQU 66 ;change cursor shape if appropriate; generate 
; null event if window was created by Dialog Manager 

accMenu .EQU 67 ;handle a given menu item 

accUndo . EQU 68 ;handle the Undo command 

accCut . EQU 70 ;handle the Cut command 

accCopy .EQU 71 ;handle the Copy command 

accPaste . EQU 72 ;handle the Paste command 

accClear . EQU 73 ;handle the Clear command 


Note: As described in the Device Manager chapter, the control routine 
may also receive the message goodBye in the csCode parameter telling 
it when the heap is about to be reinitialized. 


Along with the accEvent message, the control routine receives in the csParam 
field a pointer to an event record. The control routine must respond by handling 
the given event in whatever way is appropriate for this desk accessory. 
SystemClick and SystemEvent call the control routine with this message to send 
the driver an event that it should handle—for example, an activate event that 
makes the desk accessory active or inactive. When a desk accessory becomes 
active, its control routine might install a menu in the menu bar. If the 
accessory becoming active has more than one menu, the control routine should 
respond as follows: 


« Store the accessory's unique menu ID in the global variable 
MBarEnable. (This is the negative menu ID in the device driver 
and the device control entry.) 

¢ Call the Menu Manager routines GetMenuBar to save the current 
menu List and ClearMenuBar to clear the menu bar. 

e Install the accessory's own menus in the menu bar. 


@ SpInside Macintosh * Version 1.0 * November 1989 * Apple Computer 
THE DESK MANAGER e 15 of 19 


Then, when the desk accessory becomes inactive, the control routine should call 
SetMenuBar to restore the former menu list, call DrawMenuBar to draw the menu 
bar, and set MBarEnable to 0. 


The accRun message tells the control routine to perform the periodic action for 
this desk accessory. For every open driver that has the dNeedTime flag set, the 
SystemTask procedure calls the control routine with this message if the proper 
time period has passed since the action was last performed. 


The accCursor message makes it possible to change the shape of the cursor when 
it's inside an active desk accessory. SystemTask calls the control routine with 
this message as long as the desk accessory is active. The control routine should 
respond by checking whether the mouse location is in the desk 

accessory's window; if it is, it should set it to the standard arrow cursor (by 
calling the QuickDraw procedure InitCursor), just in case the application has 
changed the cursor and failed to reset it. Or, if desired, your accessory may 
give the cursor a special shape (by calling the QuickDraw procedure SetCursor). 


If the desk accessory is displayed in a window created by the Dialog Manager, 
the control routine should respond to the accCursor message by generating a null 
event (storing the event code for a null event in an event record) and passing 
it to DialogSelect. This enables the Dialog Manager to blink the caret in 
editText items. In assembly language, the code might look like this: 


CLR.L - (SP) sevent code for null event is 0 
PEA 2(SP) ;pass null event 

CLR.L - (SP) ;pass NIL dialog pointer 

CLR.L - (SP) ;pass NIL pointer 

_DialogSelect ;invoke DialogSelect 

ADDQ.L #4,SP ;pop off result and null event 


When the accMenu message is sent to the control routine, the following 
information is passed in the parameter block: csParam contains the menu ID of 
the desk accessory's menu and csParam+2 contains the menu item number. The 
control routine should take the appropriate action for when the given menu item 
is chosen from the menu, and then make the Menu Manager call HiliteMenu(0) to 
remove the highlighting from the menu bar. 


Finally, the control routine should respond to one of the last five 
messages—accUndo through accClear—by processing the corresponding editing 
command in the desk accessory window if appropriate. SystemEdit calls the 
control routine with these messages. For information on cutting and pasting 
between a desk accessory and the application, or between two desk accessories, 
see the Scrap Manager chapter. 


Warning: If the accessory opens a resource file, or otherwise changes 
which file is the current resource file, it should save and 
restore the previous current resource file, using the Resource 
Manager routines CurResFile and UseResFile. Similarly, the 
accessory should save and restore the port that was the current 
grafPort, using the QuickDraw routines GetPort and SetPort. 
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SUMMARY OF THE DESK MANAGER 


Routines 
Opening and Closing Desk Accessories 


FUNCTION OpenDeskAcc (theAcc: Str255) : INTEGER; 
PROCEDURE CloseDeskAcc (refNum: INTEGER); 


Handling Events in Desk Accessories 


PROCEDURE SystemClick (theEvent: EventRecord; theWindow: WindowPtr); 
FUNCTION SystemEdit (editCmd: INTEGER) : BOOLEAN; 
Performing Periodic Actions 
PROCEDURE SystemTask; 
Advanced Routines 
FUNCTION SystemEvent (theEvent: EventRecord) : BOOLEAN; 
PROCEDURE SystemMenu (menuResult: LONGINT); 
Assembly-Language Information 
Constants 
; Desk accessory flag 
dNeedTime . EQU 5 ; set if driver needs time for performing 
; a periodic action 
; Control routine messages 
accEvent .EQU 64 ;handle a given event 
accRun . EQU 65 ;take the periodic action, if any, 
; for this desk accessory 
accCursor .EQU 66 ;change cursor shape if appropriate; generate 
; null event if window was created by Dialog Manager 
accMenu .EQU 67 ;handle a given menu item 
accUndo .EQU 68 ;handle the Undo command 
accCut .EQU 70 ;handle the Cut command 
accCopy . EQU 71 ;handle the Copy command 
accPaste .EQU 72 ;handle the Paste command 
accClear .EQU 73 ;handle the Clear command 


Special Macro Names 


Pascal name Macro name 
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SystemEdit 


Variables 


_SysEdit 


MBarEnable Unique menu ID for active desk accessory, when menu bar 


SEvtEnb 


belongs to the accessory (word) 
0 if SystemEvent should return FALSE (byte) 
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Further Reference: 


Resource Manager 

QuickDraw 

Toolbox Event Manager 

Window Manager 

Menu Manager 

Device Manager 

Technical Note #5, Using Modeless Dialogs from Desk Accessories 
Technical Note #85, GetNextEvent; Blinking Apple Menu 


END OF DOCUMENT 
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